home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / image / qpng17e.zip / INSTALL.DAT / ENGLISH / QPV.DOC < prev    next >
Text File  |  1999-11-11  |  14KB  |  310 lines
  1. IMPORTANT NOTE:
  2.  
  3. This document describes the "real" QPV/386 which supports a lot of image
  4. formats.  You can get it from the same place where you got this version
  5. from which only supports PNG and TGA.
  6.  
  7. I'm just too lazy to write a new document describing this PNG-only version.
  8. However, this document also applies to this version, except:
  9.  - It only supports PNG and TGA file formats.
  10.  - It's freeware -- you can use it freely without registering (note, however,
  11.    that it's still copyrighted software, and that the distribution
  12.    restrictions below apply).
  13.  
  14.  
  15. -----------------------------------------------------------------------------
  16.  
  17.                           The "Quick Picture Viewer"
  18.                         ______________________________
  19.                         ~^~^~^~^~^~^~^~^~^~^~^~^~^~^~^
  20.  
  21.                                 Q P V / 3 8 6
  22.                               _________________
  23.                               ~^~^~^~^~^~^~^~^~
  24.  
  25.       A fast JPEG viewer for MS-DOS.  VGA graphics and 80386+ required.
  26.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  27.    Currently supports JPG, TGA, GIF, PCX, BMP, IFF/ILBM, PNM/PBM, PCD, PNG.
  28.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  29.  
  30. Copyright (c) 1993-95 by Oliver Fromme -- All Rights Reserved
  31.           Oliver Fromme, Leibnizstr. 18-61, 38678 Clausthal, Germany
  32.  
  33.           Internet email:  oliver.fromme@heim3.tu-clausthal.de
  34.           WWW:  http://www.tu-clausthal.de/~inof/Welcome.html
  35.  
  36. This program is Shareware.  You may copy the unregistered version, use it,
  37. give it to your friends, upload it to a BBS or something similar, under the
  38. following conditions:
  39.  
  40.  * Don't charge any money for it.  If you upload it to a BBS, make sure that
  41.    it can be downloaded free (without paying for downloading it, except
  42.    for usage fees that have to be paid anyway).  Small copying fees (up to
  43.    5 DM or 3 $US) may be charged.
  44.  * Only distribute the whole original package, with all the files included.
  45.  * Don't change the files in any way, except:
  46.    You may change the INI, CFG, ASM, and DRV files for private purposes.
  47.    Don't distribute modified versions of these files to others without
  48.    prior permission of the author of QPV/386.
  49.  * If you want to include QPV/386 on a CD-ROM and/or book, please send me
  50.    a free copy of the CD/book (this is not a must, but I would appreciate
  51.    it very much).
  52.  
  53. Distribution of the unregistered shareware version is explicitely desired,
  54. provided that the above conditions are accepted.
  55.  
  56. Graphics cards manufacturers:  How about bundling QPV/386 with your product?
  57. I'm sure many of your customers would appreciate that free extra bonus.
  58.  
  59. This software consists of the following files:
  60.  - QPV.EXE        the main executable file
  61.  - QPV.INI        initialization file (ASCII text)
  62.  - QPV.CFG        standard configuration file (ASCII text)
  63. Subdirectories ENGLISH (*=C) and DEUTSCH (*=K):
  64.  - QPV.DO*        the documentation
  65.  - CHANGES.DO*     list of changes from previous versions
  66.  - CONFIG.DO*      how to configure QPV/386
  67.  - FAQ.DO*         frequently asked questions
  68.  - REGISTER.DO*    how to register
  69.  - REGISTER.FRM    registration form (English)
  70.  - REGISTER.FOR    registration form (German)
  71.  - UPDATES.DO*     how to get updated versions of QPV/386
  72. Other subdirectories:
  73.  - CFG\*.CFG       various configuration files
  74.  - CFG\CFG.DOC     description of the configuration file format
  75.  - DRV\*.DRV       various video driver files
  76.  - DRVSRC\*.ASM    source codes for the video drivers
  77.  - DRVSRC\DRV.DOC  description of the video driver file format
  78.  
  79. Text files with a DOK extension are German, those with a DOC extension
  80. are English.
  81. There may also be some example JPEG files.  They are not part of the QPV/386
  82. software package.
  83.  
  84. A few warnings, disclaimer etc:
  85.  
  86. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  87. can't handle can damage your hardware!  Be sure to use only supported
  88. modes.  If you come across a mode which looks flickering or unstable
  89. (i.e. the monitor can't hold the picture), abort QPV/386 immediately and
  90. delete that mode from the configuration file.
  91.  
  92. YOU ARE USING QPV/386 AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  93. LIABLE FOR ANY DAMAGE CAUSED BY THE USE OF QPV/386 OR BY THE INABILITY
  94. TO USE QPV/386.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT
  95. THIS, THEN DO NOT USE QPV/386!
  96.  
  97. QPV/386 is inexpensive shareware.  If you continue using it after a trial
  98. period of 30 days, you are encouraged to pay a small registration fee.
  99. (I try to avoid saying that you MUST register, but actually you MUST.)
  100. The registration is valid for all future updates (you'll get a
  101. registration key which makes the delay disappear).  The source code of
  102. the JPEG decoding routines (Pascal and Asm) used by QPV/386 is also
  103. available.
  104. To become a registered user, please print the file REGISTER.FRM and send
  105. it to me with appropriate payment.  Read the file REGISTER.DOC for further
  106. information.
  107.  
  108. All product names mentioned in this software and documentation are trademarks
  109. or registered trademarks of their respective owners.  They're used in this
  110. software and documentation for identification purposes only.
  111.  
  112. "The Graphics Interchange Format(c) is the Copyright property of
  113. CompuServe Incorporated. GIF(sm) is a Service Mark property of
  114. CompuServe Incorporated."
  115.  
  116. -----------------------------------------------------------------------------
  117.  
  118. What is QPV/386?
  119. ~~~~~~~~~~~~~~~~
  120.  
  121. The "Quick Picture Viewer /386" (hereafter referred to as QPV/386) is a
  122. viewer for JPEG image files.  It is about twice as fast as other common JPEG
  123. viewers.  Compare it yourself, you'll be surprised.
  124.  
  125. JPEG (Joint Photographic Experts Group, pronounce "Jay-Peg") is an image file
  126. format which uses a "lossy" compression.  JPEG images (they have usually a
  127. "JPG" file extension) are normally very small and offer better compression
  128. than any other image format.
  129.  
  130. Decoding of JPEG images is a rather complicated process, thus it needs a lot
  131. of computing power and performance.  QPV/386 takes advantage of the advanced
  132. features of 80386, 80486 and Pentium (586) CPUs, and it uses large look-up
  133. tables instead of formulas.  Well, I don't want to get into details.  It's
  134. fast, that's all you could want to know.
  135.  
  136.  
  137. Features
  138. ~~~~~~~~
  139.  
  140.  - It's fast (have I mentioned that before?).
  141.  - Uses advanced features of 80386/486 processors (note, the Cyrix 486DLC
  142.    is only an improved 386 rather than a 486).
  143.  - Contains Pentium optimized code.  QPV/386 is immune against the
  144.    FDIV bug of Pentium processors.
  145.  - Nice preview ability which is even faster (lets you quickly browse through
  146.    lots of images, very useful if you're searching for a certain image).
  147.  - Works even with a standard VGA card (320x200x16, 640x480x16, 320x200x256).
  148.  - Supports many SVGA cards (virtually all with VESA capability).
  149.  - Uses truecolor (16M color), hicolor (32K color), 256 color (either
  150.    greyscale or dithered color), and 16 color (dithered greyscale) modes.
  151.  - You can pan across an image which is bigger than the current screen
  152.    resolution (scrolling).  Some XMS and/or EMS memory is needed for this.
  153.    You can even pan using your mouse, which is much fun (at least on fast
  154.    local bus machines).
  155.  - You can change the resolution without loading/decoding the image again
  156.    (this is restricted to the same color resolution, for example you can't
  157.    switch from hicolor to truecolor without reloading the image).
  158.  - Supports the following image file formats (more to come):
  159.     * JPEG/JFIF (see below)
  160.     * GIF:
  161.        + interlaced and non-interlaced
  162.        + GIF87a and GIF89a (87a subset only)
  163.        + displays the first image of a multi-image GIF
  164.     * Targa (TGA):
  165.        + truecolor (15, 16, 24 and 32 bit), greyscaled, or with palette
  166.        + uncompressed or rle compressed (run length encoded)
  167.        + supports all video modes (16, 256, 32K, 64K, 16M)
  168.     * PCX:
  169.        + 1 and 4 bit with standard palette
  170.        + 8 bit with extended palette
  171.        + 24 bit truecolor
  172.     * BMP (Windows)
  173.        + 1 bit monochrome with palette, uncompressed
  174.        + 4 and 8 bit with palette, uncompressed or RLE4/8 compressed
  175.        + 24 bit truecolor, uncompressed
  176.     * BMP (OS/2)
  177.        + 1, 4 and 8 bit with palette, uncompressed
  178.        + 24 bit truecolor, uncompressed
  179.        + also supports the new multi image format (BA-BMP)
  180.     * IFF/ILBM (LBM)
  181.        + 1 to 8 bit with palette, and 24 bit truecolor, also DP2 enhanced
  182.        + uncompressed or compressed (ByteRun-1)
  183.        + no HAM yet (due to lack of test images)
  184.     * PNM
  185.        + PBM (black/white), PGM (grey), PPM (truecolor)
  186.        + ASCII and raw/binary versions
  187.     * Photo-CD
  188.     * PNG ("ping")
  189.        + complies with the recommendations of the PNG specification
  190.          (draft #10 and version 0.92)
  191.        + supports gamma, interlacing, alpha and transparency.
  192.  
  193.  
  194. Requirements
  195. ~~~~~~~~~~~~
  196.  
  197.  - 80386 or better CPU (33 MHz or faster recommended), 386SX is sufficient
  198.  - VGA graphics card (SuperVGA recommended, though QPV/386 will run on any
  199.    standard VGA card)
  200.  - some XMS and/or EMS memory (depending on the size of the images), though
  201.    QPV/386 will also run without any XMS/EMS, but then you will be unable to
  202.    do any panning/scrolling
  203.  - about 500 to 550 Kb of free conventional memory
  204.  - MS-DOS 5.0 or compatible operating system
  205.  
  206. A mouse is not required, but it's much more fun than keyboard control!
  207.  
  208. A numeric coprocessor is not required.  If present, it will not be used,
  209. because it would not speed up decoding/displaying.
  210.  
  211.  
  212. Using QPV/386
  213. ~~~~~~~~~~~~~
  214.  
  215. At first you have to configure QPV/386 for your video hardware by running
  216. the SETUP utility once.  Please read the CONFIG.DOC file for more
  217. information.
  218.  
  219. Then just type 'QPV' to run it.  There are some command line options
  220. (type 'QPV /?' to get a help message), but they're usually not needed.
  221.  
  222. The graphical user interface of QPV/386 is rather intuitive, so there is no
  223. need for much documentation.  Press the 'F1' key to get a list of all
  224. keyboard functions.  Hit '?' to get a list of keys that can be used while
  225. viewing an image.  You can quit QPV/386 at any time by pressing Alt-X.
  226.  
  227. QPV/386 can also be used as command line viewer (without graphical user
  228. interface).  Type 'QPV/386' followed by one or more filenames.  Wildcards
  229. ('*' and '?') are allowed, too.  Type 'QPV /?' for more information.
  230.  
  231. Experienced users should have a look at the initialization file QPV.INI.
  232. It offers many possibilities to change QPV/386's behaviour, you can even
  233. enable some advanced features which are disabled by default (e.g. automatic
  234. video mode selection).  It's a standard ASCII text file, containing
  235. detailed comments for each topic.
  236. Some of these setting can also be changed while QPV/386 is running:
  237. press Alt-O (while the directory listing is displayed) to enter an options
  238. window.
  239.  
  240.  
  241. Restrictions and Bugs
  242. ~~~~~~~~~~~~~~~~~~~~~
  243.  
  244. QPV/386 can't handle all kinds of JPEG images.  Specifically, it can only
  245. decode files which comply with the JFIF standard.
  246. See 'Technical Information' below for more details.
  247.  
  248. The maximum image width is 4000 pixel.  QPV/386 will refuse to decode larger
  249. images.  The image height is not limited, but if it's too large it may not
  250. fit into memory (XMS/EMS), thus you can't see the bottom part when scrolling
  251. down.  If this happens, try to use a video mode with less colors, because it
  252. needs less memory (see FAQ.DOC).  Or buy more memory :-)
  253.  
  254.  
  255. How to get an updated version of QPV/386
  256. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  257.  
  258. Please refer to the UPDATES.DOC file.
  259.  
  260.  
  261. Revision history and changes from prior versions
  262. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  263.  
  264. Please refer to the CHANGES.DOC file.
  265.  
  266.  
  267. Technical Information
  268. ~~~~~~~~~~~~~~~~~~~~~
  269.  
  270. QPV/386 can decode greyscaled images (containing a single component using
  271. h1v1 upsampling) and YCbCr true color images (containing three interleaved
  272. components in a single scan, using either Yh2v2, Yh2v1 or Yh1v1 upsampling
  273. for Y and Ch1v1 for Cb/Cr), covering virtually all JFIF files in use today.
  274.  
  275. QPV/386 can handle files that contain restart markers, but it will not use
  276. them for error recovery.  QPV/386 can also display JPEG files which were
  277. created with the 'Adobe Photoshop' (at least version 2.5).
  278.  
  279. The basic JPEG decoding routines are written in pure 386 assembly language,
  280. everything else is written using Borland Pascal 7.0.  I am not using
  281. protected mode, because it would slow down the decoding rather than speeding
  282. it up.  I have linked the JPEG routines into a single easy to use Pascal
  283. unit, which can also be used within other applications.  If you want to
  284. purchase the unit, please read the file REGISTER.DOC for more information.
  285.  
  286. The JPEG unit provides procedures to open and close a JPEG file, read the
  287. file header, and read the image row by row.  It contains routines which
  288. return the lines as 24 bit true color RGB/BGR, 15/16 bit hicolor, 256 color
  289. dithered, 256 color greyscaled, 16 color grayscaled/dithered, and 16 color
  290. greyscaled/dithered for preview (scaled to one eigth or one fourth).
  291.  
  292. A DLL library which can be used for Windows and protected mode applications
  293. available now, see REGISTER.DOC.  It can decode and create JPEG files.
  294.  
  295.  
  296. Epilogue
  297. ~~~~~~~~
  298.  
  299. Special thanks to:
  300.    Thomas Mönkemeier, Lutz Kotoll, Thilo W. Fischer, Rainer Klaffehn,
  301.    Walter Schmies, Stefan Engel, Ben Jos Walbeehm, Uwe Schlenther,
  302.    Bryan Woodworth, Rafal Wiezbicki, Piotr Warezak,
  303.    and all of my beta testers!
  304.  
  305. All product names mentioned in this software and documentation are trademarks
  306. or registered trademarks of their respective owners.  They're used in this
  307. software and documentation for identification purposes only.
  308.  
  309. -----------------------------------------------------------------------------
  310.